VIDIZMO Mashup Node
The VIDIZMO Mashup Node manages content within your VIDIZMO platform, enabling workflows to publish, delete, and manage timed data for videos and other media. It supports operations for creating new content, updating existing mashups, managing transcriptions and OCR data, and adding vector embeddings for semantic search. The node connects directly to the VIDIZMO API using authenticated user context, respecting all portal access controls and permissions.
How It Works
The VIDIZMO Mashup node connects directly to your VIDIZMO platform's API using your authenticated user context. When the node executes, it constructs an API request based on the selected operation, combining route parameters (like mashup UUID), query parameters (like parts to update), and body content (like mashup information objects). The node automatically includes your user authentication token and tenant domain from the workflow runtime context, ensuring operations execute with proper permissions and target the correct VIDIZMO instance.
Upon execution, the node sends the request to the VIDIZMO API endpoint corresponding to the selected operation. For publish operations, the API processes the mashup information and updates the specified parts. For delete operations, the API removes the mashup or moves it to trash based on configuration. For timed data operations, the API adds, updates, or removes time-synchronized metadata like transcriptions or OCR results. The API response, containing operation results or updated mashup information, is stored in the specified output variable for use by downstream workflow nodes.
The node operates within your VIDIZMO tenant's security context, respecting all access controls, permissions, and policies configured in your portal. Operations that modify content require appropriate user permissions, and the node fails if the authenticated user lacks necessary rights. This ensures workflow automation maintains the same security boundaries as manual portal operations.
Configuration Parameters
Output field
Output Field (Text, Required): Workflow variable where operation results are stored.
The output contains the API response from VIDIZMO. For publish operations, the output includes the updated mashup information with the parts requested to return. For delete operations, the output confirms successful deletion. For timed data operations, the output contains confirmation of added, updated, or deleted timed data records.
Common naming patterns: mashup_result, publish_response, delete_status
Operation
Operation (Dropdown, Required): The VIDIZMO Mashup API operation to perform.
| Operation | What it does | Use for |
|---|---|---|
| Publish Mashup | Creates new or updates existing mashup | Publishing videos, updating metadata, modifying content properties |
| Delete Mashup | Removes a single mashup | Deleting individual videos or content items |
| Delete Mashups in Bulk | Removes multiple mashups at once | Batch deletion of content, cleanup operations |
| Add Timed Data | Adds time-synchronized metadata | Adding transcriptions, OCR results, custom timed annotations |
| Update Timed Data | Modifies existing timed data | Correcting transcriptions, updating metadata |
| Delete Timed Data | Removes timed data by criteria | Removing outdated transcriptions, cleaning up metadata |
| Add Embeddings | Adds vector embeddings for search | Enabling semantic search, AI-powered content discovery |
Publish Mashup
Publishes a new mashup or updates an existing one in your VIDIZMO portal.
Mashup UUID (Text, Required): Unique identifier of the mashup to publish. For new mashups, provide a newly generated UUID. For updates, use the existing mashup's UUID. Variable interpolation with ${mashup_uuid} is supported.
Mashup Parts to Update (Multi-select, Optional): Parts of the mashup to update. Leave empty to update all parts. Available parts include BasicInfo (title, description), Tags, Content (media files), CustomAttributes, Categories, Thumbnails, and more. Only selected parts are processed, improving performance for partial updates.
Parts to Return (Multi-select, Optional): Parts to include in the response. Controls what data is returned after the operation completes for retrieving specific information without fetching the entire mashup object.
Child Access Right Policy (Dropdown, Optional): How to handle access rights for child mashups in collections. Delete removes child access rights, Keep Copy preserves them. Only applies when publishing collection-type mashups.
Mashup Info (Object, Required): MashupInfo object containing mashup details including properties like title, description, content URLs, metadata, and configuration. Typically sourced from a workflow variable containing a structured mashup object. Variable interpolation with ${mashup_info} is supported.
Delete Mashup
Deletes a single mashup from your VIDIZMO portal.
Mashup UUID (Text, Required): Unique identifier of the mashup to delete. Variable interpolation with ${mashup_uuid} is supported.
Mashup ID (Number, Required): Numeric ID of the mashup. Required in addition to UUID for delete operations. Variable interpolation with ${mashup_id} is supported.
Force Delete (Toggle, Default: false): When enabled, permanently deletes the mashup without moving it to trash. When disabled, the mashup is moved to the recycle bin and can be restored.
Delete Children (Toggle, Default: false): When enabled, deletes child mashups when deleting a collection. When disabled, child mashups are preserved even if the parent collection is deleted. Only applies to collection-type mashups.
Delete Mashups in Bulk
Deletes multiple mashups in a single operation.
Mashup UUIDs (Text, Required): Comma-separated mashup UUIDs to delete (e.g., uuid1,uuid2,uuid3). Variable interpolation with ${mashup_uuids} is supported for dynamic lists.
Mashup IDs (Array, Required): List of numeric mashup IDs to delete. Typically sourced from a workflow variable containing an array of IDs. Variable interpolation with ${mashup_ids} is supported.
Force Delete (Toggle, Default: false): When enabled, permanently deletes all mashups without moving them to trash. When disabled, mashups are moved to the recycle bin.
Add Timed Data
Adds time-synchronized metadata to a mashup.
Mashup UUID (Text, Required): Unique identifier of the mashup. Variable interpolation with ${mashup_uuid} is supported.
Mashup ID (Number, Required): Numeric ID of the mashup. Variable interpolation with ${mashup_id} is supported.
Timed Data List (Array, Required): List of MashupTimedDataInfo objects containing timed metadata. Each object includes properties like start time, end time, data type (transcription, OCR, etc.), content, and culture. Variable interpolation with ${timed_data_list} is supported.
Update Timed Data
Updates existing time-synchronized metadata for a mashup.
Mashup UUID (Text, Required): Unique identifier of the mashup. Variable interpolation with ${mashup_uuid} is supported.
Timed Data List (Array, Required): List of MashupTimedDataInfo objects with updated content. Objects must include the timed data ID to identify which records to update. Variable interpolation with ${timed_data_list} is supported.
Delete Timed Data
Removes time-synchronized metadata based on specified criteria.
Mashup UUID (Text, Required): Unique identifier of the mashup. Variable interpolation with ${mashup_uuid} is supported.
Timed Data Criteria (Object, Required): Deletion criteria to target specific timed data:
- Mashup ID: Numeric mashup ID. Variable interpolation with
${mashup_id}is supported. - Mashup UUID: Mashup unique identifier. Variable interpolation with
${mashup_uuid}is supported. - Timed Data IDs: List of specific timed data IDs to delete. Variable interpolation with
${timed_data_ids}is supported. - Timed Data Types: Types to delete (All, Transcription, OCR, Face, Brand, Geospatial, Binary, Chat, QnA). Leave empty to delete all types.
- Cultures: List of culture codes (e.g.,
en-US,es-ES) to target specific language versions. Variable interpolation with${cultures}is supported. - Tenant IDs: List of tenant IDs for multi-tenant scenarios. Variable interpolation with
${tenant_ids}is supported.
Add Embeddings
Adds vector embeddings to enable semantic search and AI-powered content discovery.
Mashup UUID (Text, Required): Unique identifier of the mashup. Variable interpolation with ${mashup_uuid} is supported.
Point Info List (Array, Required): List of PointInfoES objects containing embedding vectors and metadata. Each object includes the embedding vector, associated text or content, and indexing information. Typically generated by embedding nodes earlier in the workflow. Variable interpolation with ${point_info_list} is supported.
Common Parameters
This node supports common parameters shared across workflow nodes, including Stream Output Response, Streaming Messages, and Logging Mode. For detailed information, see Common Parameters.
Best Practices
- Use workflow variables to store mashup objects and IDs rather than hardcoding values for reusable and maintainable workflows
- When publishing mashups, specify only the parts to update rather than updating all parts to improve performance and reduce risk of unintended changes
- Implement confirmation logic or conditional checks before bulk delete operations to prevent accidental deletion of important content
- Ensure MashupTimedDataInfo objects include proper start and end times in the correct format, as invalid timing causes display issues
- Consider using standard delete (moving to trash) rather than force delete in production workflows for recovery safety
- Ensure embedding vectors match the dimensionality expected by your VIDIZMO search configuration to avoid indexing failures
Limitations
- Authentication context: The node uses the workflow execution user's authentication token and permissions. Operations fail if the user lacks necessary rights for the requested operation.
- Mashup object structure: The node expects properly structured MashupInfo and MashupTimedDataInfo objects. Malformed objects or missing required fields cause API errors.
- Bulk operations: Bulk delete operations process all items in a single transaction. If any item fails, the entire operation may fail depending on VIDIZMO API behavior.
- Timed data types: The available timed data types are fixed (Transcription, OCR, Face, Brand, etc.). Custom timed data types must be configured in VIDIZMO before use.